home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat3 / Tk / image.z / image
Encoding:
Text File  |  2002-10-03  |  4.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. iiiimmmmaaaaggggeeee((((3333TTTTkkkk))))                                                          iiiimmmmaaaaggggeeee((((3333TTTTkkkk))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      image - Create and manipulate images
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      iiiimmmmaaaaggggeeee _o_p_t_i_o_n ?_a_r_g _a_r_g ...?
  13.  
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      The iiiimmmmaaaaggggeeee command is used to create, delete, and query images.  It can
  17.      take several different forms, depending on the _o_p_t_i_o_n argument.  The
  18.      legal forms are:
  19.  
  20.      iiiimmmmaaaaggggeeee ccccrrrreeeeaaaatttteeee _t_y_p_e ?_n_a_m_e? ?_o_p_t_i_o_n _v_a_l_u_e ...?
  21.           Creates a new image and returns its name.  _t_y_p_e specifies the type
  22.           of the image, which must be one of the types currently defined
  23.           (e.g., bbbbiiiittttmmmmaaaapppp).  _n_a_m_e specifies the name for the image;  if it is
  24.           omitted then Tk picks a name of the form iiiimmmmaaaaggggeeee_x, where _x is an
  25.           integer.  There may be any number of _o_p_t_i_o_n-_v_a_l_u_e pairs, which
  26.           provide configuration options for the new image.  The legal set of
  27.           options is defined separately for each image type;  see below for
  28.           details on the options for built-in image types.  If an image
  29.           already exists by the given name then it is replaced with the new
  30.           image and any instances of that image will redisplay with the new
  31.           contents.
  32.  
  33.      iiiimmmmaaaaggggeeee ddddeeeelllleeeetttteeee _n_a_m_e
  34.           Deletes the image named _n_a_m_e and returns an empty string.  If there
  35.           are instances of the image displayed in widgets, the image won't
  36.           actually be deleted until all of the instances are released.
  37.           However, the association between the instances and the image manager
  38.           will be dropped.  Existing instances will retain their sizes but
  39.           redisplay as empty areas.  If a deleted image is recreated with
  40.           another call to iiiimmmmaaaaggggeeee ccccrrrreeeeaaaatttteeee, the existing instances will use the
  41.           new image.
  42.  
  43.      iiiimmmmaaaaggggeeee hhhheeeeiiiigggghhhhtttt _n_a_m_e
  44.           Returns a decimal string giving the height of image _n_a_m_e in pixels.
  45.  
  46.      iiiimmmmaaaaggggeeee nnnnaaaammmmeeeessss
  47.           Returns a list containing the names of all existing images.
  48.  
  49.      iiiimmmmaaaaggggeeee ttttyyyyppppeeee _n_a_m_e
  50.           Returns the type of image _n_a_m_e (the value of the _t_y_p_e argument to
  51.           iiiimmmmaaaaggggeeee ccccrrrreeeeaaaatttteeee when the image was created).
  52.  
  53.      iiiimmmmaaaaggggeeee ttttyyyyppppeeeessss
  54.           Returns a list whose elements are all of the valid image types
  55.           (i.e., all of the values that may be supplied for the _t_y_p_e argument
  56.           to iiiimmmmaaaaggggeeee ccccrrrreeeeaaaatttteeee).
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiimmmmaaaaggggeeee((((3333TTTTkkkk))))                                                          iiiimmmmaaaaggggeeee((((3333TTTTkkkk))))
  71.  
  72.  
  73.  
  74.      iiiimmmmaaaaggggeeee wwwwiiiiddddtttthhhh _n_a_m_e
  75.           Returns a decimal string giving the width of image _n_a_m_e in pixels.
  76.  
  77.  
  78. BBBBUUUUIIIILLLLTTTT----IIIINNNN IIIIMMMMAAAAGGGGEEEE TTTTYYYYPPPPEEEESSSS
  79.      The following image types are defined by Tk so they will be available in
  80.      any Tk application.  Individual applications or extensions may define
  81.      additional types.
  82.  
  83.      bbbbiiiittttmmmmaaaapppp
  84.           Each pixel in the image displays a foreground color, a background
  85.           color, or nothing.  See the bbbbiiiittttmmmmaaaapppp manual entry for more
  86.           information.
  87.  
  88.      pppphhhhoooottttoooo
  89.           Displays a variety of full-color images, using dithering to
  90.           approximate colors on displays with limited color capabilities.  See
  91.           the pppphhhhoooottttoooo manual entry for more information.
  92.  
  93.  
  94. KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  95.      height, image, types of images, width
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.